home *** CD-ROM | disk | FTP | other *** search
/ QRZ! Ham Radio 21 / QRZ Ham Radio Callsign Database - Volume 21.iso / QRZHELP.TXT < prev    next >
Text File  |  2001-04-12  |  9KB  |  222 lines
  1. -------------------------------------------------------------------
  2. QRZ Command Processor Help File (Version 1.0)
  3.  
  4. This information is for the MSDOS version of the QRZ.EXE lookup
  5. program.
  6.  
  7. At the main QRZ! prompt, the following commands are valid:
  8.  
  9.      <callsign> Looks up the callsign 
  10.      N .........Searches the Name database.
  11.      S..........Searches the City/State database.
  12.      Z..........Searches the Zip Code database.
  13.      M..........Takes you to the setup menu (printing, files, etc.).
  14.      H or ?.....Gets you this help.   
  15.      Q..........Exits the program.
  16.  
  17.  
  18. Command Detail
  19.  
  20. The QRZ command processor expects that the user will input either a
  21. callsign pattern or a command.  All commands are single letter.  Any
  22. group of two or more letters in a row is considered a callsign lookup
  23. command.  For example, if you type 'abc' at the command prompt, the
  24. program will look up all callsigns which end in the letters 'ABC'.
  25. The entire database is upper case and all user input is converted
  26. to upper case so all commands and patterns are case insensitive.
  27.  
  28. <callsign>  When a multiple letter pattern is input, the program uses
  29.    it to find a matching callsign or callsigns.  The search engine does
  30.    callsign suffix matching, that is, the letters which follow the
  31.    number (and the number itself) in a callsign.  The program does not
  32.    do prefix (e.g. WB1*) matching.
  33.  
  34. N  This command performs lookups in the person names database.
  35.    In a multi-parameter input line, the command may be given as 'n
  36.    last first' where 'last' is the person's last name and 'first' is
  37.    their first or surname.  The name pattern search ignores middle
  38.    initials.  You can use the star '*' character to mean all FIRST
  39.    names in the database.  The '*' character may be used with last
  40.    names after the first letter(s).  For example, the command 
  41.    'n s* *) will list all people whose last name begins with an 's'.
  42.    The first name part (if given) is always considered to be first*
  43.    so if you type 'n smith fred' you'll get both Fred Smith and 
  44.    Fredrick Smith.  .  If you type only 'N' by itself, the program
  45.    will prompt you for the last and then the first name to look for.
  46.    Arguments which contain spaces (e.g. "Le May" or "Jean Luc")
  47.    must be enclosed in double quotes.
  48.  
  49. S  This command performs lookups in the City/State database. The
  50.    command operates similar to the 'N' command in that '*' may be used
  51.    to with the city part.  If you do not supply the city and state
  52.    parameters on the command line, the program will prompt you for
  53.    input.  City names which contain spaces must be quoted within
  54.    double quotes (e.g. 's  mo "saint louis"' returns all hams
  55.    living in Saint Louis, Missouri).
  56.  
  57. Z  This command performs lookups in the Zip Code database.  The 'Z'
  58.    command expects a single zipcode to follow it, as in 'z 90210'.  If
  59.    you do not supply the zipcode after the 'Z', the program will prompt
  60.    you for it.
  61.  
  62. M  The 'M' commands are used to access the Setup Menu.  The setup
  63.    menu allows you to control such things as turning printers on and
  64.    off, sending output to a file, turning screen output on or off, and
  65.    a selection of data output formats.  There are 11 classes of 'M'
  66.    commands, which can be seen by simply typing 'M'.  'M' commands can
  67.    be stacked on a command line.  Take for example the command:
  68.  
  69.    m 2 d:\test m 4 m 3 s * nv
  70.  
  71.    This is a compound command which says
  72.         
  73.         m 2 d:\test   <- write output to file called d:\test
  74.         m 4           <- select mailing label format
  75.         m 3           <- turn off screen output
  76.         s * nv        <- lookup all cities in Nevada
  77.  
  78.  
  79.    Typing 'M' with no arguments invokes the interactive setup menu.
  80.    The default setup menu has the following status display:
  81.  
  82.          1)  Output to Printer.........OFF
  83.          2)  Output to File............OFF
  84.          3)  Output to Screen..........ON
  85.          4)  Mailing Label Format......OFF
  86.          5)  Raw Record Format.........OFF
  87.          6)  Book Format...............OFF
  88.          7)  Screen Format ............ON
  89.          8)  Pause on Full Screen......ON
  90.          9)  Records Per Page..........6
  91.  
  92.       Enter item # to CHANGE or Q to exit -> 
  93.  
  94.  
  95. The M Commands
  96.  
  97. Output Directors - selects output destination(s).  Any (or none)
  98.     of the following destinations may be simultaneously selected.
  99.  
  100.    M 1 - Send Output to Printer.  On/Off Toggle.  Sends all output to
  101.          The printer.  Screen output is suspended (may be turned back
  102.          on with M 3).  M 1 turns the printer on or off each time it is
  103.          invoked.
  104.  
  105.    M 2 [filename] - Send Output to File.  On/Off Toggle.  Sends all
  106.         output to the file <filename>.  Screen output is suspended (may
  107.         be turned back on with M 3)
  108.  
  109.    M 3 - Send Output to Screen. On/Off Toggle.  Used in conjunction
  110.          with commands M 1 and M 2 above to force screen output ON.
  111.  
  112. Format Selectors - Any one of M 4 thru M 8 may be selected at any time.
  113.  
  114.    M 4 - Mailing Label Format.  Records are output in a format suitable
  115.          for printing on mailing labels.  Records are output in a three
  116.          line format with a leading and trailing blank line (5 lines
  117.          per record).
  118.  
  119.    M 5 - Raw Record Format. -  Records are output as a single line of
  120.          text with comma separated fields (see the file qrz_tech.txt
  121.          for field descriptions.
  122.  
  123.    M 6 - Book Format - Records are output in a one-line format similar
  124.          to that found in printed callsign books.  Calls are output
  125.          aligned by their call area number.
  126.  
  127.    M 7 - Screen Format - Default.  Records are output in the default
  128.          three line screen format.  The [o] (camera) symbol means
  129.          that a .GIF file exists for this callsign in D:\callbk\gifs
  130.  
  131. Utility Commands
  132.  
  133.    M 8 - Pause on Full Screen.  Toggle.  Directs the program wether
  134.          to pause output on each full screen of data.  ON by default
  135.          except when called from the non interactive command line.
  136.  
  137.    M 9 [num] - Records Per Page.  Used to reset the number or records
  138.          shown before the screen pauses.  Set by default when any of
  139.          M 4 thru M 7 are selected.
  140.  
  141.    M 0 - Reset to Defaults.  Used to reset all M parameters to their
  142.          initial values.  Closes any files (from M 2) which may be
  143.          open.  Resets to M 3, M 7, and M 8 ON.
  144.  
  145.    M S - M Status.  Displays the status of each of the M parameters.
  146.  
  147.  
  148. Compound Commands
  149.  
  150.    Any of the commands above including the M commands may be given
  151.    as multiple comands on the same line.  For example, it is possible
  152.    to open a named file, make a format selection, select a class of
  153.    records and close the file with a single line like:
  154.  
  155.    M 2 smiths.txt m 4 n smith "*" M 2 
  156.  
  157.    This command opens a file called smiths.txt, chooses the mailing
  158.    label output format, selects all records whose last name is 'Smith'
  159.    and then closes the file.
  160.  
  161.  
  162. Command Line Invocation
  163.  
  164.    Commands and arguments may be passed to the qrzcom program directly
  165.    from the command line.  For example, the compound command shown
  166.    above could be executed directly from the command line as:
  167.  
  168.    C:\> QRZCOM M 2 smiths.txt m 4 n smith "*" M 2
  169.    C:\>
  170.  
  171.  
  172. Using with Pipes
  173.  
  174.    When piping the output of another program into qrzcom, use the
  175.    '-' character to indicate that input is coming from a pipe.  When
  176.    the '-' is used, qrzcom will execute silently.
  177.  
  178.    C:\> TYPE FRIENDS.TXT | QRZCOM -
  179.  
  180.         <output listing...>
  181.    C:\>
  182.  
  183.  
  184. The QRZ.INI File
  185.  
  186.    This file, if present in the user's current path (or QRZPATH), may
  187.    contain a list of commands to execute upon startup.  There is no
  188.    limit to the number of commands this file may contain.  If this file
  189.    ends with the Q command, the program will exit rather than returning
  190.    to the command mode.
  191.  
  192.  
  193. Environment Variables
  194.  
  195.    QRZPATH  If set, is used to indicate the pathname to the directory
  196.       containing the QRZ! data files.  Normally x:\callbk is automatically
  197.       chosen by the program on startup.
  198.  
  199.    QRZDRV   If set, indicates the drive letter (DOS ONLY) to use with
  200.       QRZPATH above.
  201.  
  202.  
  203. Program Availabilty
  204.  
  205.    The program is normally available for MSDOS machines.  A version for
  206.    UNIX is also available which contains exactly the same features.
  207.  
  208.  
  209. Shareware
  210.  
  211.    This program may be freely copied for the exclusive use with the
  212.    QRZ! Ham Radio CDROM.
  213.  
  214.  
  215. Comments
  216.  
  217.    Send your comments to Fred Lloyd, AA7BQ   flloyd@qrz.com
  218.  
  219. ------------------- End of Help ------------------------
  220.  
  221. 
  222.